home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat31 / iobject / doc / iobject.docfr < prev   
Encoding:
Text File  |  1993-03-23  |  23.7 KB  |  950 lines
  1. TABLE OF CONTENTS
  2.  
  3.  
  4. IObject.lib/ActivateObject
  5. IObject.lib/AddObjectToWindow
  6. IObject.lib/AdjustBox
  7. IObject.lib/ClearTextArea
  8. IObject.lib/CreateObject
  9. IObject.lib/CreateTextArea
  10. IObject.lib/DisplayObject
  11. IObject.lib/Draw3DBox
  12. IObject.lib/EraseObject
  13. IObject.lib/ExitEasyGadget
  14. IObject.lib/FindObjectMsg
  15. IObject.lib/FreeObject
  16. IObject.lib/FreeTextArea
  17. IObject.lib/GetHotKey
  18. IObject.lib/GetObjectID
  19. IObject.lib/InitEasyGadget
  20. IObject.lib/ModifyObject
  21. IObject.lib/ObjectValue
  22. IObject.lib/OffObject
  23. IObject.lib/OnObject
  24. IObject.lib/RemoveObjectFromWindow
  25. IObject.lib/SendMsgToObject
  26. IObject.lib/SetTextAreaPen
  27. IObject.lib/SetIObjectColors
  28. IObject.lib/TAPrint
  29. IObject.lib/TAPrintf
  30. IObject.lib/TAPuts
  31.  
  32.  
  33. IObject.lib/ActivateObject                         IObject.lib/ActivateObject
  34.  
  35.   NOM  ActivateObject() -- Simule l'activation d'un IObject
  36.  
  37.     ActivateObject(object);
  38.  
  39.     VOID ActivateObject(CPTR);
  40.  
  41.   DESCRIPTION
  42.     Simule l'activation d'un IObject par un utilisateur, permet de gérer les
  43.     raccourcis-clavier. Tous les IObject ne sont pas affectés par cette
  44.     fonction (Par ex. l'activation d'un Scroller n'a aucun sens).
  45.  
  46.   ENTREES
  47.     object  - pointeur sur l'IObject.
  48.  
  49.   RESULTAT
  50.     aucun
  51.  
  52.   BOGUES
  53.     pas de bugs connus
  54.  
  55.  
  56. IObject.lib/AddObjectToWindow                   IObject.lib/AddObjectToWindow
  57.  
  58.   NOM  AddObjectToWindow() -- Ajoute un IObject à une fenêtre
  59.  
  60.     AddObjectToWindow(object, window, requester);
  61.  
  62.     VOID AddObjectToWindow(CPTR, struct Window *, struct Requester *);
  63.  
  64.   DESCRIPTION
  65.     Attache un IObject à une fenêtre, l'IObject n'est pas affiché sur la
  66.     fenêtre (Il faut utiliser DisplayObject pour l'afficher). Pour pouvoir
  67.     gérer les IObject il faut que la fenetre possede les IDCMP flags corres-
  68.     pondant aux IObjects ajoutés (IDCMP_xxxx).
  69.  
  70.   ENTREES
  71.     object    - pointeur sur le IObject.
  72.     window    - pointeur sur la fenêtre qui recoit l'IObject.
  73.     requester - pointeur sur le requester qui recoit l'IObject.
  74.  
  75.   RESULTAT
  76.     aucun
  77.  
  78.   BOGUES
  79.     Pour l'instant, on ne peut pas ajouter un IObject à un requester. Mettre
  80.     NULL pour le requester.
  81.  
  82.   VOIR AUSSI
  83.     RemoveObjectFromWindow()
  84.  
  85.  
  86. IObject.lib/AdjustBox                                   IObject.lib/AdjustBox
  87.  
  88.   NOM  AdjustBox() -- Calcule la boite à l'interieur d'une bordure
  89.  
  90.     AdjustBox(box, simple);
  91.  
  92.     VOID AdjustBox(struct Box *, BOOL);
  93.  
  94.   DESCRIPTION
  95.     Permet de calculer la taille et la position d'une boite à l'intérieur
  96.     d'une bordure (simple ou double) définie par box.
  97.  
  98.   ENTREES
  99.     box    - la boite qui sera ajustée. (box est modifiée)
  100.     simple - TRUE si c'est une bordure simple (BOX_1IN ou BOX_1OUT).
  101.  
  102.   RESULTAT
  103.     aucun
  104.  
  105.   BOGUES
  106.     pas de bugs connus
  107.  
  108.  
  109. IObject.lib/ClearTextArea                           IObject.lib/ClearTextArea
  110.  
  111.   NOM  ClearTextArea() -- efface le  TextArea
  112.  
  113.     ClearTextArea(textarea);
  114.  
  115.     VOID ClearTextArea(CPTR);
  116.  
  117.   DESCRIPTION
  118.     Efface le TextArea, et remet le curseur en haut du TextArea.
  119.  
  120.   ENTREES
  121.     textarea - pointeur sur le TextArea.
  122.  
  123.   RESULTAT
  124.     aucun
  125.  
  126.   
  127. IObject.lib/Createxxxx                                 IObject.lib/Createxxxx
  128.  
  129.   NOM  Createxxxx() -- Crée un IObject
  130.  
  131.     object = Createxxxx(new, id);
  132.  
  133.     CPTR Createxxxx(struct Newxxxx *, ULONG);
  134.  
  135.   DESCRIPTION
  136.  
  137.     Chaque classes d'IObjects possède une structure NewObject:
  138.  
  139.       struct NewObject
  140.       {
  141.         UWORD  LeftEdge, TopEdge;
  142.         UWORD  Width, Height;
  143.         UWORD  Flags;
  144.         UWORD  ClassFlags;
  145.         STRPTR LabelText;
  146.         struct TextAttr *Font;
  147.       };
  148.  
  149.     LeftEdge, TopEdge - Position de l'IObjet dans la fenêtre.
  150.     Width, Height     - Taille de l'IObject.
  151.     Flags             - Flags généraux pour tous les IObject, pour placer le
  152.                         label par rapport à l'IOject (LABEL_ABOVE au dessus,
  153.                         LABEL_BELOW en dessous, LABEL_RIGHT à droite,
  154.                         LABEL_LEFT à gauche, LABEL_INSIDE à l'interieur),
  155.                         LABEL_HOT_KEY permet de souligner le caractère
  156.                         précédé par '_' dans le label, LABEL_PEN2  utilise la
  157.                         couleur pen2 pour afficher le label (pen1 par défaut),
  158.                         OBJ_DISABLED pour rendre l'IObject unselectionnable.
  159.     ClassFlags        - flags spécifique à chaque classe (Voir plus loin).
  160.     LabelText         - Texte du label (peut être NULL).
  161.     Font              - Fonte utilisée par l'IObject. Un programme qui utilise
  162.                         IObject.lib doit déclarer la variable DiskfontBase,
  163.                         si vous n'ouvrez pas la diskfont.library, initialisez
  164.                         DiskfontBase à NULL, vous ne pourrez alors utiliser
  165.                         que les  fontes en ROM. Si la fonte ne peut pas être
  166.                         ouverte ou si Font est NULL, IObject.lib utilisera la
  167.                         fonte standard (Topaz 8).
  168.  
  169.   CLASS_CYCLE:
  170.  
  171.     CPTR CreateCycle(struct NewCycle *, ULONG);
  172.  
  173.     Crée un IObject qui permet de choisir une option parmi plusieurs.
  174.  
  175.       struct NewCycle
  176.       {
  177.         struct NewObject NewObj;
  178.         STRPTR *TextArray;
  179.       };
  180.  
  181.     ClassFlags - Aucun flags pour les Cycle
  182.     TextArea   - tableau de chaine pour les differentes options du cycle,
  183.                  doit se terminer par NULL.
  184.  
  185.   CLASS_BUTTON:
  186.  
  187.     CPTR CreateButton(struct NewButton *, ULONG);
  188.  
  189.     Crée un bouton, il peut servir d'interrupteur en utilisant BT_TOGGLE.
  190.  
  191.       struct NewButton
  192.       {
  193.         struct NewObject NewObj;
  194.       };
  195.  
  196.     ClassFlags - BT_TOGGLE transforme le bouton en interrupteur, il peut être
  197.                  selectionné ou non selectionné. BT_SELECTED selectionne
  198.                  l'interrupteur. Avec BT_IMAGELABEL on peut utiliser une image
  199.                  à la place du label, il faut mettre un pointeur sur une image
  200.                  dans le champ Label. (l'image est centrée dans le bouton).
  201.  
  202.   CLASS_SCROLLER
  203.     
  204.     CPTR CreateScroller(struct NewScroller *, ULONG);
  205.  
  206.     Crée un IObject proportionnel, comme ceux utilisés dans les éditeurs de
  207.     textes pour ce déplacer dans le texte: indique le nombre de lignes
  208.     visible par rapport au nombre totale de ligne et la position dans le
  209.     texte.
  210.  
  211.       struct NewScroller
  212.       {
  213.         struct NewObject NewObj;
  214.         UWORD Pos;
  215.         UWORD CurSize;
  216.         UWORD MaxSize;
  217.       };
  218.  
  219.     ClassFlags - SC_VERTICAL permet d'avoir un scroller vertical, en utilisant
  220.                  SC_NOMOUSE le scroller ne prend pas en compte les évenements
  221.                  de la souris pour calculer sa position.
  222.     Pos        - Position du knob dans le scroller: de zéro à MaxSize.
  223.     CurSize    - Correspond à la partie visible.
  224.     MaxSize    - Correspond à la partie totale.
  225.  
  226.   CLASS_CHECK:
  227.  
  228.     CPTR CreateCheck(struct NewCheck *, ULONG);
  229.  
  230.     Crée un IObject qui peut servir d'interrupteur.
  231.  
  232.       struct NewCheck
  233.       {
  234.         struct NewObject NewObj;
  235.       };
  236.  
  237.     ClassFlags - CK_CHECKED si on veut que le check soit selectionné.
  238.  
  239.   CLASS_STRING:
  240.  
  241.     CPTR CreateString(struct NewString *, ULONG);
  242.  
  243.     Crée un IObject pour saisir une chaine de caratères.
  244.  
  245.       struct NewString
  246.       {
  247.         struct NewObject NewObj;
  248.         STRPTR Text;
  249.         UWORD  MaxLength;
  250.       };
  251.  
  252.     ClassFlags - STR_SINGLEBORD permet d'avoir une bordure simple au lieu
  253.                  d'une bordure double, STR_RIGHT et STR_CENTER permet de
  254.                  positionner le texte dans l'IObject: soit justifié à droite
  255.                  soit centré.
  256.     Text       - Texte dans le String au départ. (peut être NULL)
  257.     MaxLength  - Longueur maximale de la chaine à saisir. (MaxLength doit
  258.                  être inférieur à 280 pour l'instant).
  259.  
  260.   CLASS_INTEGER:
  261.  
  262.     CPTR CreateInteger(struct NewInteger *, ULONG);
  263.  
  264.     Crée un IObject pour saisir un entier long signé, on peut spécifier les
  265.     valeurs minimale et maximale que peut prendre cet entier avec la fonction
  266.     ModifyObject(). (Par défaut LONG_MIN et LONG_MAX.)
  267.  
  268.       struct NewInteger
  269.       {
  270.         struct NewObject NewObj;
  271.       };
  272.  
  273.     ClassFlags - voir ClassFlags pour le String.
  274.  
  275.   ENTREES
  276.     new - pointeur sur la structure Newxxxx correspondant à la classe de
  277.           l'IObject.
  278.     id  - numéro d'identification pour l'utilisateur.
  279.  
  280.   RESULTATS
  281.     object - pointeur sur l'IObject ou NULL si on ne peut pas le créer.
  282.  
  283.   BOGUES
  284.     pas de bugs connus
  285.  
  286.   SEE ASLO
  287.     FreeObject(), ModifyObject()
  288.  
  289.  
  290. IObject.lib/CreateTextArea                         IObject.lib/CreateTextArea
  291.  
  292.   NOM  CreateTextArea() -- Crée un TextArea
  293.  
  294.     textarea = CreateTextArea(newtextarea, rastport);
  295.  
  296.     CPTR CreateTextArea(struct NewTextArea *, struct RastPort *);
  297.  
  298.   DESCRIPTION
  299.     Crée un TextArea pour afficher du texte qui scrolle automatiquement quand
  300.     le texte a atteint le bas du TextArea. La structure NewTextArea est
  301.     composée de:
  302.  
  303.       struct NewTextArea
  304.       {
  305.         UWORD  LeftEdge, TopEdge;
  306.         UWORD  Width, Height;
  307.         UWORD  Flags;
  308.         UWORD  ClassFlags;
  309.         STRPTR LabelText;
  310.         struct TextAttr *Font;
  311.         UBYTE  FrontPen, BackPen;
  312.         UBYTE  InterLine;
  313.         UBYTE  WrMask;
  314.       };
  315.  
  316.     LeftEdge, TopEdge - définie la position du TextArea dans le rastport.
  317.     Width, Height     - définie la taille du TextArea dans le rastport.
  318.     Flags             - LABEL_ABOVE, LABEL_RIGHT, LABEK_LEFT, LABEL_BELOW,
  319.                         LABEL_PEN2 (cf CreateObject.)
  320.     ClassFlags        - Flags pour le TextArea:  TAF_SMOOTH_SCROLL pour avoir
  321.                         un scrolling plus fin (prend plus de temps), avec le
  322.                         flag TAF_CLIP_TEXT le texte qui est plus large que le
  323.                         TextArea est affiché à la ligne suivante, sinon le
  324.                         texte qui dépasse n'est pas affiché.
  325.     LabelText         - Label du TextArea.
  326.     Font              - Fonte qui sera utilisée pour le TextArea.
  327.     FrontPen          - Couleur du texte dans le TextArea.
  328.     BackPen           - Couleur du fond.
  329.     InterLine         - Espace entre deux ligne de texte, 1 permet d'aérer le
  330.                         texte. (0 est possible).
  331.     WrMask            - Masque pour les bitplanes du TextArea, les bits 1 à 8
  332.                         indiquent quels bitplanes seront utilisés pour écrire
  333.                         dans le TextArea. (1 bit à 1 veut dire que le bitplane
  334.                         correspond est utlisé). Par exemple pour un écran de
  335.                         profondeur 3, si vous voulez utiliser toutes les cou-
  336.                         leurs mettez 0x07, si vous ne voulez utiliser que les
  337.                         couleurs 1 à 4 mettez 0x03. Ce champs correspont au
  338.                         champs WrMask de la structure RastPort. Mettez -1 si
  339.                         ne vous savez  pas quoi mettre. (Moins il y a de
  340.                         bitplanes utilisés plus l'affichage sera rapide. si
  341.                         vous mettez 0, rien ne sera écrit.)
  342.  
  343.   ENTREES
  344.     newtextarea - pointeur sur une structure NewTextArea initialisé.
  345.     rastport    - pointeur sur un rastport.
  346.  
  347.   RESULTAT
  348.     textarea - pointeur sur un TextArea ou NULL si on ne peut pas le créer.
  349.  
  350.   VOIR AUSSI
  351.     FreeTextArea(), TAPrint(), TAPrintf(), TAPuts(), graphics/rastport.h
  352.  
  353.  
  354. IObject.lib/DisplayObject                           IObject.lib/DisplayObject
  355.  
  356.   NOM  DisplayObject() -- Affiche un IObject
  357.  
  358.     DisplayObject(object);
  359.  
  360.     VOID DisplayObject(CPTR);
  361.  
  362.   DESCRIPTION
  363.     Affiche un IObject dans une fenêtre, IL FAUT d'abord ajouter l'IObject à
  364.     une fenêtre avec AddObjectToWindow() avant d'utiliser DisplayObject().
  365.  
  366.   ENTREES
  367.     object - pointeur sur l'IObject.
  368.  
  369.   RESULTAT
  370.     aucun
  371.  
  372.   BOGUES
  373.     pas de bugs connus
  374.  
  375.   VOIR AUSSI
  376.     EraseObject()
  377.  
  378.  
  379. IObject.lib/Draw3DBox                                   IObject.lib/Draw3DBox
  380.  
  381.   NOM  Draw3DBox() -- Dessine une boite 3D
  382.  
  383.     Draw3DBox(boite, rastport, type);
  384.  
  385.     VOID Draw3DBox(struct Box *, struct RastPort *, ULONG);
  386.  
  387.   DESCRIPTION
  388.     Dessine la bordure définie par la boite dans un rastport. La bordure peut
  389.     être simple (BOX_1x) ou double (BOX_2x).
  390.  
  391.   ENTREES
  392.     boite    - pointeur sur une boite.
  393.     rastport - pointeur sur un rastport.
  394.     type     - type de la bordure (BOX_1IN, BOX_1OUT, BOX_2IN et BOX_2OUT).
  395.  
  396.   RESULTAT
  397.     aucun
  398.  
  399.   VOIR AUSSI
  400.     SetIObjectColors()
  401.  
  402.  
  403. IObject.lib/EraseObject                               IObject.lib/EraseObject
  404.  
  405.   NOM  EraseObject() -- Efface un IObject
  406.  
  407.     EraseObject(object);
  408.  
  409.     VOID EraseObject(CPTR);
  410.  
  411.   DESCRIPTION
  412.     Efface un IObject de la fenêtre; l'IObject n'est pas retiré de la fenêtre
  413.     il est seulement effacé.
  414.  
  415.   ENTREES
  416.     object - pointeur sur l'IObject.
  417.  
  418.   RESULTAT
  419.     aucun
  420.  
  421.   BOGUES
  422.     pas de bugs connus
  423.  
  424.   VOIR AUSSI
  425.     DisplayObject()
  426.  
  427.  
  428. IObject.lib/ExitEasyGadget                         IObject.lib/ExitEasyGadget
  429.  
  430.   NOM  ExitEasyGadget() -- Libere la mémoire utilisée par IObject.lib
  431.  
  432.     ExitEasyGadget();
  433.  
  434.     VOID ExitEasyGadget();
  435.  
  436.   DESCRIPTION
  437.     Avant de rendre la main au système vous DEVEZ appeler ExitEasyGadget().
  438.  
  439.   ENTREES
  440.     aucun
  441.  
  442.   RESULTAT
  443.     aucun
  444.  
  445.   BOGUES
  446.     pas de bugs connus
  447.  
  448.   VOIR AUSSI
  449.     InitEasyGadget()
  450.  
  451.  
  452. IObject.lib/FindObjectMsg                           IObject.lib/FindObjectMsg
  453.  
  454.   NOM  FindObjectMsg() -- Chercher l'IObject associé au message
  455.  
  456.     object = FindObjectMsg(message);
  457.  
  458.     CPTR FindObjectMsg(struct IntuiMessage *);
  459.  
  460.   DESCRIPTION
  461.     Cherche à quel IObject appartient l'IntuiMessage, renvoie le pointeur sur
  462.     un IObject si le message appartient à un IObject ou NULL sinon.
  463.  
  464.   ENTREES
  465.     message - pointeur sur une structure IntuiMessage.
  466.  
  467.   RESULTAT
  468.     object - pointeur sur l'IObject associé à l'IntuiMessage ou NULL.
  469.  
  470.   BOGUES
  471.     pas de bugs connus
  472.  
  473.  
  474. IObject.lib/FreeObject                                 IObject.lib/FreeObject
  475.  
  476.   NOM  FreeObject()  -- Libère un IObject
  477.  
  478.     FreeObject(object);
  479.  
  480.     VOID FreeObject(CPTR);
  481.  
  482.   DESCRIPTION
  483.     Libère la mémoire utilisée par l'IObject, vous devez retirer l'IObject
  484.     de la fenêtre avant de le libérer. (Vous n'êtes pas obliger de le retirer
  485.     de la fenêtre si vous fermez la fenêtre juste aprés la libération)
  486.  
  487.   ENTREES
  488.     object - pointeur sur l'IObject.
  489.  
  490.   RESULTAT
  491.     aucun
  492.  
  493.   BOGUES
  494.     pas de bugs connus
  495.  
  496.   VOIR AUSSI
  497.     Createxxx()
  498.  
  499.  
  500. IObject.lib/FreeTextArea                             IObject.lib/FreeTextArea
  501.  
  502.   NOM  FreeTextArea()  -- Libére un TextArea
  503.  
  504.     FreeTextArea(textarea);
  505.  
  506.     VOID FreeTextArea(CPTR);
  507.  
  508.   DESCRIPTION
  509.     Libere le TextArea crée par CreateTextArea().
  510.  
  511.   ENTREES
  512.     textarea - pointeur sur le textarea.
  513.  
  514.   RESULTAT
  515.     aucun
  516.  
  517.   BOGUES
  518.     pas de bugs connus
  519.  
  520.   VOIR AUSSI
  521.     CreateTextArea()
  522.  
  523.  
  524. IObject.lib/GetHotKey                                    IObject.lib/GetHotKey
  525.  
  526.   NOM  GetHotKey() -- Donne la HotKey d'un IObject
  527.  
  528.     car = GetHotKey(object);
  529.  
  530.     UBYTE GetHotKey(CPTR);
  531.  
  532.   DESCRIPTION
  533.     Renvoie le raccourcis-clavier utilisé par un IObject ou renvoie 0 s'il
  534.     n'a pas de raccourcis-clavier (Si l'IObject est unselectionnable on
  535.     renvoie 0 même si l'IObject a un raccourcis-clavier).
  536.  
  537.   ENTREES
  538.     object - pointeur sur l'IObject.
  539.  
  540.   RESULTAT
  541.     car - le raccourcis-clavier ou 0.
  542.  
  543.   BOGUES
  544.     pas de bugs connus
  545.  
  546.  
  547. IObject.lib/GetObjectID                               IObject.lib/GetObjectID
  548.  
  549.   NOM  GetObjectID() -- Renvoie l'ID de l'IObject
  550.  
  551.     id = GetObjectID(object);
  552.  
  553.     UWORD GetObjectID(CPTR);
  554.  
  555.   DESCRIPTION
  556.     Renvoie l'ID donné à l'IObject lors de sa création par Create.
  557.  
  558.   ENTREES
  559.     object - pointeur sur l'IObject.
  560.  
  561.   RESULTAT
  562.     id - le numéro affecté à l'IObject lors de sa création.
  563.  
  564.   BOGUES
  565.     pas de bugs connus
  566.  
  567.  
  568. IObject.lib/InitEasyGadget                         IObject.lib/InitEasyGadget
  569.  
  570.   NOM  InitEasyGadget() -- Initialise IObject.lib
  571.  
  572.     res = InitEasyGadget();
  573.  
  574.     BOOL InitEasyGadget();
  575.  
  576.   DESCRIPTION
  577.     Cette routine DOIT être appelée avant d'utiliser la IObject.lib, renvoie
  578.     TRUE si l'initialisation c'est passée sans problème, sinon renvoie FALSE
  579.     et la librarie n'est pas utilisable.
  580.  
  581.   ENTREES
  582.     aucun
  583.  
  584.   RESULTAT
  585.     res - renvoie TRUE si on peut utiliser la IObject.lib ou FALSE sinon.
  586.  
  587.   BOGUES
  588.     pas de bugs connus
  589.  
  590.   VOIR AUSSI
  591.     ExitEasyGadget()
  592.  
  593.  
  594. IObject.lib/ModifyObject                             IObject.lib/ModifyObject
  595.  
  596.   NOM  ModifyObject() -- modifie un IObject.
  597.  
  598.     ModifyObject(object, arg0, arg1, ...);
  599.  
  600.     VOID ModifyObject(CPTR, ...);
  601.  
  602.   DESCRIPTION
  603.     Modifie un IObject, le prototype de la fonction dépend de la classe de
  604.     l'IObject.
  605.  
  606.   ENTREES
  607.     object - pointeur sur l'IObject.
  608.  
  609.     CLASS_CYCLE
  610.       ModifyObject(object, textarray, numero);
  611.       VOID ModifyObject(CPTR, STRPTR *, ULONG);
  612.  
  613.       Change le TextArray du cycle, et l'option selectionné.
  614.  
  615.     textarray - nouveau tableau de texte a utiliser, ou NULL pour garder le
  616.                 même.
  617.     numero    - numero de l'option selectionnée.
  618.  
  619.     CLASS_SCROLLER
  620.       ModifyObject(object, position, visible, max);
  621.       VOID ModifyObject(CPTR, ULONG, ULONG, ULONG);
  622.  
  623.       Change la position du Knob, la taille courante et le taille maximale.
  624.  
  625.     position - position du Knob.
  626.     visible  - partie visible.
  627.     max      - maximun possible.
  628.  
  629.     CLASS_BUTTON
  630.       ModifyObject(object, select);
  631.       VOID ModifyObject(CPTR, BOOL);
  632.  
  633.       Sélectionne ou désélectionne un bouton (le bouton doit posséder le flag
  634.       BT_TOGGLE).
  635.  
  636.     select - TRUE si le bouton doit être selectionné.
  637.  
  638.     CLASS_INTEGER
  639.       ModifyObject(object, val, min, max);
  640.       VOID ModifyObject(CPTR, LONG, LONG, LONG);
  641.  
  642.       Définie la valeur de l'entier et la valeur maximale et minimale que peut
  643.       prendre l'entier.
  644.  
  645.     val - valeur de l'entier.
  646.     min - valeur minimale de l'entier.
  647.     max - valeur maximale de l'entier.
  648.  
  649.     CLASS_STRING
  650.       ModifyObject(object, texte);
  651.       VOID ModifyObject(CPTR, STRPTR);
  652.  
  653.       Change le texte de l'IObject.
  654.  
  655.     texte - texte pour le String.
  656.  
  657.     CLASS_CHECK
  658.       ModifyObject(object, select);
  659.       VOID ModifyObject(CPTR, BOOL);
  660.  
  661.       Coche ou non le Check.
  662.  
  663.     select - TRUE pour cocher la CheckBox.
  664.  
  665.   RESULTAT
  666.     aucun
  667.  
  668.   BOGUES
  669.     pas de bugs connus
  670.  
  671.  
  672. IObject.lib/ObjectValue                                IObject.lib/ObjectValue
  673.  
  674.   NOM  ObjectValue() -- Renvoie l'état d'IObject
  675.  
  676.     val = ObjectValue(object);
  677.  
  678.     CPTR ObjectValue(CPTR);  (le type de val dépend de la classe de l'IObject)
  679.  
  680.   DESCRIPTION
  681.     Renvoie la valeur de l'IObject.
  682.  
  683.   ENTREES
  684.     object - pointeur de l'IObject.
  685.  
  686.   RESULTAT
  687.     CLASS_CYCLE:
  688.       index = ObjectValue(object);
  689.       UWORD ObjectValue(CPTR);
  690.  
  691.       renvoie le numéro de l'option sélectionnée.
  692.  
  693.     CLASS_SCROLLER:
  694.       pos = ObjectValue(object);
  695.       UWORD ObjectValue(CPTR);
  696.  
  697.       renvoie la position du knob.
  698.  
  699.     CLASS_BUTTON:
  700.       select = ObjectValue(object);
  701.       BOOL ObjectValue(CPTR);
  702.  
  703.       spécifie si le bouton est sélectionné.
  704.  
  705.     CLASS_INTEGER:
  706.       val = ObjectValue(object);
  707.       LONG ObjectValue(CPTR);
  708.  
  709.       Renvoie la valeur de l'entier.
  710.  
  711.     CLASS_STRING:
  712.       texte = ObjectValue(object);
  713.       STRPTR ObjectValue(CPTR);
  714.  
  715.       Renvoie le pointeur sur texte.
  716.  
  717.     CLASS_CHECK:
  718.       select = ObjectValue(object);
  719.       BOOL ObjectValue(CPTR);
  720.  
  721.       Spécifie si l'IObject est coché.
  722.  
  723.   BOGUES
  724.     pas de bugs connus
  725.  
  726.  
  727. IObject.lib/OffObject                                    IObject.lib/OffObject
  728.  
  729.   NOM  OffObject()  -- Ghoste un IObject
  730.  
  731.     OffObject(object);
  732.  
  733.     VOID OffObject(CPTR);
  734.  
  735.   DESCRIPTION
  736.     Rend l'IObject unselectionnable (Ghost). Pour rendre l'IObject à nouveau
  737.     selectionnable il faut utiliser OnObject().
  738.  
  739.   ENTREES
  740.     object - pointeur sur l'IObject.
  741.  
  742.   RESULTAT
  743.     aucun
  744.  
  745.   BOGUES
  746.     pas de bugs connus
  747.  
  748.   VOIR AUSSI
  749.     OnObject()
  750.  
  751.  
  752. IObject.lib/OnObject                                     IObject.lib/OnObject
  753.  
  754.   NOM  OnObject() -- UnGhoste un IObject
  755.  
  756.     OnObject(object);
  757.  
  758.     VOID OnObject(CPTR);
  759.  
  760.   DESCRIPTION
  761.     Rend l'IObject selectionnable, c'est le contraire de OffObject().
  762.  
  763.   ENTREES
  764.     object - pointeur sur l'IObject.
  765.  
  766.   RESULTAT
  767.     aucun
  768.  
  769.   BOGUES
  770.     pas de bugs connus
  771.  
  772.   VOIR AUSSI
  773.     OffObject()
  774.  
  775.  
  776. IObject.lib/RemoveObjectFromWindow         IObject.lib/RemoveObjectFromWindow
  777.  
  778.   NOM  RemoveObjectFromWindow() -- Retire un IObject de sa fenêtre
  779.  
  780.     RemoveObjectFromWindow(object);
  781.  
  782.     VOID RemoveObjectFromWindow(CPTR);
  783.  
  784.   DESCRIPTION
  785.     Retire un IObject de la fenêtre associé. L'IObject n'est pas effacé de la
  786.     fenêtre, pour l'effacer il faut faire un EraseObject avant de le retirer.
  787.  
  788.   ENTREES
  789.     object - pointeur sur l'IObject.
  790.  
  791.   RESULTAT
  792.     aucun
  793.  
  794.   BOGUES
  795.     pas de bugs connus
  796.  
  797.   VOIR AUSSI
  798.     AddObjectToWindow(), EraseDisplay()
  799.  
  800.  
  801. IObject.lib/SendMsgToObject                        IObject.lib/SendMsgToObject
  802.  
  803.   NOM  SendMsgToObject() -- Envoie un IntuiMessage à un IObject
  804.  
  805.     modif = SendMsgToObject(object, message);
  806.  
  807.     BOOL SendMsgToObject(CPTR, struct IntuiMessage *);
  808.  
  809.   DESCRIPTION
  810.     Envoie un IntuiMessage à un IObject, l'IObject provient de la fonction
  811.     FindObjectMsg(), renvoie TRUE si l'IObject a été modifié. Il faut utiliser
  812.     ObjectValue() pour recupérer le nouvel état de l'IObject.
  813.  
  814.   ENTREES
  815.     object  - pointeur sur l'IObject.
  816.     message - pointeur sur une structure IntuiMessage.
  817.  
  818.   RESULTAT
  819.     modif - renvoie TRUE si l'IObject a été modifié ou FALSE sinon.
  820.  
  821.   BOGUES
  822.     pas de bugs connus
  823.  
  824.   VOIR AUSSI
  825.     FindObjectMsg(), ObjectValue()
  826.  
  827.  
  828. IObject.lib/SetTextAreaPen                         IObject.lib/SetTextAreaPen
  829.  
  830.   NAME  SetTextAreaPen() -- Change les couleurs du TextArea
  831.  
  832.     SetTextAreaPen(textarea, front, back);
  833.  
  834.     VOID SetTextAreaPen(CPTR, UBYTE, UBYTE);
  835.  
  836.   DESCRIPTION
  837.     Change les couleurs du TextArea. Si vous changez la couleur de fond vous
  838.     devez effacer l'ecran.
  839.  
  840.   ENTREES
  841.     textarea - pointeur sur le TextArea.
  842.     front    - couleur du texte.
  843.     back     - couleur du fond du TextArea.
  844.  
  845.   RESULTAT
  846.     none
  847.  
  848.  
  849. IObject.lib/SetIObjectColors                     IObject.lib/SetIObjectColors
  850.  
  851.   NOM  SetIObjectColors() -- Initialise les couleurs pour IObject.lib
  852.  
  853.     SetIObjectColors(back, light, dark, pen1, pen2);
  854.  
  855.     VOID SetIObjectColors(UBYTE, UBYTE, UBYTE, UBYTE, UBYTE);
  856.  
  857.   DESCRIPTION
  858.     Initialise les couleurs utilisées par IObject.lib pour dessiner les
  859.     bordures, pour effacer les IObjects et pour la couleurs des labels.
  860.  
  861.   ENTREES
  862.     back  - couleur utiliséd pour effacer les IObjects.
  863.     light - couleur pour le coté claire des bordures.
  864.     dark  - couleur pour coté sombre des bordures.
  865.     pen1  - couleur normale pour les labels.
  866.     pen2  - couleur des labels utilisant LABEL_PEN2.
  867.  
  868.   RESULTAT
  869.     aucun
  870.  
  871.   BOGUES
  872.     pas de bugs connus
  873.  
  874.  
  875. IObject.lib/TAPrint                                        IObject.lib/TAPrint
  876.  
  877.   NOM  TAPrint() -- Affiche un texte dans un TextArea
  878.  
  879.     TAPrint(textarea, texte);
  880.  
  881.     TAPrint(CPTR, STRPTR);
  882.  
  883.   DESCRIPTION
  884.     Ecrit un texte dans le textarea. le texte peut utiliser des retours
  885.     chariots (\n en C).
  886.  
  887.   ENTREES
  888.     textarea - pointeur sur le textarea.
  889.     texte    - le texte à afficher.
  890.  
  891.   RESULTAT
  892.     aucun
  893.  
  894.   BOGUES
  895.     les tabulations ne sont pas gérées.
  896.  
  897.   VOIR AUSSI
  898.     TAPrintf(), TAPuts()
  899.  
  900.  
  901. IObject.lib/TAPrintf
  902.  
  903.   NOM  TAPrintf() -- Affiche un texte formaté dans un TextArea
  904.  
  905.     TAPrintf(textarea, fmttexte, arg1, arg2, ...);
  906.  
  907.     VOID TAPrintf(CPTR, STRPTR, ...);
  908.  
  909.   DESCRIPTION
  910.     Affiche un texte avec des paramétres comme la fonction printf du C.
  911.  
  912.   ENTREES
  913.     textarea        - pointeur sur le TextArea.
  914.     fmttexte        - texte avec les styles de formattage de RawDoFmt().
  915.     arg1, arg2, ... - parametres pour le fmttexte.
  916.  
  917.   RESULTAT
  918.     aucun
  919.  
  920.   BOGUES
  921.     pas de bugs connus
  922.  
  923.   VOIR AUSSI
  924.     RawDoFmt(), TAPuts(), TAPrint()
  925.  
  926.  
  927. IObject.lib/TAPuts                                         IObject.lib/TAPuts
  928.  
  929.   NOM  TAPuts() -- Affiche un texte avec retour chariot dans un TextArea
  930.  
  931.     TAPuts(textarea, texte);
  932.  
  933.     VOID TAPuts(CPTR,char *);
  934.  
  935.   DESCRIPTION
  936.     même fonction que TAPrint à part que l'on fait un retour chariot.
  937.  
  938.   ENTREES
  939.     textarea - pointeur sur le textarea.
  940.     texte    - le texte à afficher.
  941.  
  942.   RESULTAT
  943.     aucun
  944.  
  945.   BOGUES
  946.     les tabulations ne sont pas gérées.
  947.  
  948.   VOIR AUSSI
  949.     TAPrintf(), TAPrint()
  950.